home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / the_acc.lzh / theacc.doc < prev    next >
Text File  |  1988-04-23  |  16KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                  The Accessory
  9.                                   Version 1.0
  10.  
  11.     Written by:
  12.  
  13.     Daniel H. McKee
  14.     14A Elm St.
  15.     Mt. Home AFB, ID 83648
  16.     1-208-832-4504
  17.  
  18.     Genie - D.M.
  19.     Compuserve - 75766,1515
  20.     Delphi - ELMAC
  21.  
  22.     Source code written in TDI's Modula-2
  23.  
  24.     If you find this accessory or the source code useful, a contribution
  25.     would be appreciated. Any comments, improvements, or bugs of the
  26.     accessory, please pass them on to me.
  27.  
  28.  
  29.     Overview
  30.  
  31.          Sometimes during the course of an GEM program,  for instance, word
  32.     processing, there may be a need to format a disk or do  some  file
  33.     erasing  and copying.  If there  is  no  desk  top functions,  then you
  34.     had to save your work,  exit the program, and then run the program
  35.     again.  With this accessory you will be  able to format that disk,
  36.     save or erase that file, and a host of other desk top functions.
  37.  
  38.     Accessory features
  39.  
  40.     With this accessory you can go the following functions:
  41.  
  42.     - Disk format
  43.     - Copy files
  44.     - Erase files
  45.     - Disk copy
  46.     - Create a folder
  47.     - Erase a folder
  48.     - Get disk free space
  49.     - Print a file directory
  50.     - Rename a file
  51.     - Set file attributes
  52.     - Set write verify
  53.  
  54.  
  55.     Installation
  56.  
  57.          Copy the files below to your boot disk.  If you have a hard drive,
  58.     copy the files to drive C.
  59.  
  60.          THEACC.ACC - the desk accessory
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.          THEACCC.RSC - color resource file
  74.          THEACCM.RSC - monochrome resource file
  75.  
  76.          If  you do not put the resource file on the boot  disk,  then this
  77.     accessory will not run! The menu item for the accessory will be there
  78.     and if you click on it,  an alert box will indicate  that the resource
  79.     was not loaded.
  80.          This accessory will run on a 520 or 1040 ST in medium or high
  81.     resolution. It will not run in low  resolution,  if however you try to
  82.     run this accessory in low resolution,  an alert box will indicate that
  83.     the accessory will not operate.
  84.  
  85.     Using the accessory
  86.  
  87.          To  use  this  accessory select the  menu  item  called  The
  88.     Accessory.  The  accessory  will  open up  and  present  all  the
  89.     features that are available.  The large dialog on the left side of the
  90.     accessory is used for a file directory,  more about this later. The
  91.     dialog label FILE INFO is where you can rename and set the  file
  92.     attributes.  To the right FILE INFO is the dialog for formatting a
  93.     disk.  Below  the format dialog box,  is the dialog to do  file and
  94.     disk copying.  Also,  directly below that is the button to erase files.
  95.     To  the left of the Copy Options is another dialog to erase  and create
  96.     folders. To exit the accessory, click with the mouse arrow on the DONE
  97.     button or simple press the RETURN key.
  98.  
  99.     The file directory
  100.          This section of the accessory is used to display the files of a
  101.     selected drive, get the free space(the remaining bytes left on a
  102.     disk),  and  print  out a hard copy of  a  selected  path.
  103.          The directory is similar in the use to the  Item Selector use in
  104.     many GEM programs. The directory  will display up to twelve files at a
  105.     time.  A  folder will be indicated with a graphic character(CHR(5)) at
  106.     the beginning of the name. Scrolling the file directory is accomplished
  107.     in the same manner as the standard item selector. Use the up or down
  108.     arrows to scroll one line, use the track to scroll a page, or click on
  109.     the slider and drag it to the desired position.
  110.          To select a file name, simply move the mouse to the displayed file
  111.     names and click with the left mouse button. As you continue to hold
  112.     down the  left  mouse  button and move the mouse in  the  area of  the
  113.     displayed  files,  the file name will be deselected and selected. Also,
  114.     the current selected file will displayed next to the  files under the
  115.     Selection. If you click on a folder,  it will open  up and the contents
  116.     will be displayed. Now, to close up the folder can be accomplished two
  117.     ways. First,  move  the mouse up to the top of the displayed files  and
  118.     click  on the long box that displays the current path,  this  will
  119.     return you to the previous selected path. Second, Click the mouse on
  120.     the  current selected drive,  this  will  return you to  the  root
  121.     directory.
  122.          The directory also will give you what drives are available on your
  123.     system.  There is a possibility of 16 drives,  if you have  a hard
  124.     disk  or a ram disk,  these will be  accessible  with  this accessory.
  125.     To change to another drive, simple click with the mouse on the desired
  126.     drive and the contents will be displayed.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.          Another  feature of the directory is getting the  free  space
  140.     remaining  on a disk.  Click with the mouse on BYTES  REMAINING button
  141.     and the space available of the current selected drive  will be
  142.     displayed.  To find the free space on other drives,  select one of the
  143.     available drives and click on the BYTES REMAINING again.
  144.          The  finally option available in the directory is printing  a hard
  145.     copy of your files.  There is two printing options available. The
  146.     first  one is called ONE ACROSS  This will  print  one file per line
  147.     with the file name, date, time, and size information. The second
  148.     option,  THREE  ACROSS  will only print out the file name and  size,
  149.     but three  file names and sizes on one line. Whatever option that  is
  150.     decide  on,  the  print out will be of the selected path  that  is
  151.     displayed  in the long box just above the displayed  files.  Also, the
  152.     print out will include the selected path,  how many bytes  use in that
  153.     path, and the bytes remaining on the disk. To print, click with  the
  154.     mouse on the PRINT button. If you forget to  turn  on your  printer,
  155.     or there is some other problem after you click  on the print button, an
  156.     Alert dialog will  indicate this condition.
  157.  
  158.     Renaming and setting file attributes
  159.          This  option  allow  you to rename a file and  set  the  file
  160.     attributes.  To  use  this option,  select a file  name  from  the
  161.     directory.   The   desired  name  will  be  displayed  under   the
  162.     Selection box.  Once this is accomplished,  move the mouse up to the
  163.     dialog that is named FILE INFO and click on that button. The file name
  164.     will be displayed along with the size,  date,  and time. Also,  the
  165.     file attributes will be indicated,  the R/O  means  the file  is  read
  166.     only and R/W shows the file is read  or  write   To rename a file,
  167.     move the cursor up to the file name, either use the arrow  keys or
  168.     mouse to move the cursor,  then use the  back space, delete,  etc.. to
  169.     edit the file name. Once this is done then press the SET button to
  170.     rename the file. If you just want to reset the file attributes,  simple
  171.     select the desire button and click on the SET button.  If a file has a
  172.     R/O attribute, you must first set the file attribute to R/W before a
  173.     file can be renamed.
  174.  
  175.     Formatting a disk
  176.          Next  to  the FILE INFO is the dialog to format  a  disk.  To
  177.     format  a disk,  select the desired drive by clicking on  A  for drive
  178.     A or  B for drive B.  Next select the one of the  buttons below  the
  179.     drive selection.  The S button is for  single  sided format  and  the D
  180.     button is for double  sided  format. Another option allows for two
  181.     different formats. The default the standard format that is you get from
  182.     GEM Desk Top. This gives you approximately  357,000 bytes for single
  183.     sided and  726,000 bytes for double sided.
  184.         The  optional  format  available with this  accessory  allows  for
  185.     approximately 408,000 bytes for single sided and 828,000 bytes for
  186.     double sided.  To change to the optional format,  press the button that
  187.     displays 9/80  This will change to a  10/80   indicating the  optional
  188.     format.